home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d19
/
irsuser1.arc
/
IRSUSER.DOC
< prev
next >
Wrap
Text File
|
1991-04-28
|
8KB
|
178 lines
/* IRSUSER.C V1.0 beta April 22, 1991 */
/* Copyright (c) 1991 David Boyd and Joe Dargie */
/* Tested and compatible with PCBoard 14.5a beta*/
/* Source may be modified but can not be used */
/* in any commercial environment for profit */
/* without prior permission from David Boyd */
/* and Joe Dargie */
/* Support/suggestions/complaints can be made */
/* via modem at (401) 539-8636 24 hours/day */
/* 7 days/week-The Information Resource System */
Table of Contents...
Table of Contents.......................................page i
What this program does?.................................page 1
Why did I write it and how much does it cost?...........page 1
Who am I?...............................................page 1
Who actually wrote IRSUSER?.............................page 1
How do you use IRSUSER?.................................page 2
What else is there you need to know?....................page 2
Obligations and promises................................page 3
Legal mumbo-jumbo.......................................page 3
This document is totally unnecessary! Simply type the name of
the program - IRSUSER - and a screen will appear giving you the
necessary command line parameters and syntax. I've only
included this document because, if you're like me, you like to
RTFM and get to know something about the programmer behind the
program! If this is the first time you've used IRSUSER then
just make a backup copy of your PCBoard USERS file and use the
backup copy - NOT YOUR ORIGINAL. The original file sizes and
dates included in this distribution file is in a file called
IRSFILES.DOC in order to ease your worries (although a couple
Michelob Dry's would probably do just as well).
IRSHIST.DOC is included for your curiosity's sake.
PCBoard is a registered trademark of Clark Development Company, Inc.
Turbo C is a registered trademark of Borland International, Inc.
<page i>
What this program does...
IRSUSER.EXE will read your PCBoard 14.5a USERS file (it will
never *write* to this file) and audit all users with a
specific security level and then check to see if their
expiration date has expired.
It then creates a file (which can be used as a bulletin) with
the names of all successfull matches and the expired user's name
will be in lower case while the non-expired user's name will be
in upper case (hey, rank does have it's privileges!).
Why did I write it and how much does it cost?...
I wanted a way to search my PCBoard USERS file and create a
list of names of callers that were a specific security level.
I use this file for a bulletin and maintain it daily during
my BBS's daily maintenance event. Simple, huh?!
The program COSTS NOTHING and is being uploaded into the great
world of Public Domain software! All I ask is that no-one try
to use it commercially to make a profit from it. If you want to
send me something please send a message with your comments,
likes, dis-likes, and any enhancements you can think of. I
won't make any promises to include all enhancements but I do
promise to handle likes and dis-likes appropriately!
Who am I?...
If you're like me, before I run any program I like to know who
the person is that wrote it. My name is Joe Dargie and I'm the
Sysop of The Information Resource System BBS (The IRS BBS).
I'm a member of the ILink mail network and can be reached in the
ILink Sysop conference or on my BBS (300-9600 baud USR HST soon
to be Dual Standard).
The I.R.S. BBS
Box 606
Carolina, RI 02812
(401) 539-8636
Who actually wrote IRSUSER?...
Well, I started it but it was mainly written by my Co-Sysop
David Boyd. I'm just beginning to learn programming and decided
to start with the 'C' programming language. I asked David a few
questions and he turned around and gave me examples of code
which wound up being the entire program. With my suggestions
and a few modifications we worked on IRSUSER together. Dave
created most of the code while I watched, er, helped and wrote
the documentation. I took several classes in 'C' programming but
learned more from David than any book or instructor. Thanks Dave!
<page 1>
How do you use IRSUSER?...
IRSUSER is meant to be used during a system maintenance event.
It is command line driven and the syntax is as follows:
IRSUSER.EXE Users_file Bulletin_file Security_level [title.ext] [caption.ext]
where...
IRSUSER.EXE is the name of the executable program
Users_file is the full path and name of your PCBoard USERS file
Bulletin_file is the full path and name of the text file which
is to be created
Security_level is an integer from 1-255 representing the
security level you wish to search for
[title.ext] is an optional text file which you create and is
placed at the top of the Bulletin_file
[caption.ext] is an optional text file which you create and is
placed at the end of the Bulletin_file
Both [title.ext] and [caption.ext] are optional and need not be
included (it will default to my I.R.S title and caption). All
other command line parameters are mandatory and must be placed
in the position's as shown above.
You can see a brief explanation of the above by simply running
IRSUSER.EXE without any command line parameters.
How much memory it uses is unknown but I have run it in as little
as 145K RAM. You will need to insure that you have enough disk
space to handle the file which is created. With my simple title
and caption screens and about 50 names it takes about 2K of disk
space.
What else is there you need to know?...
It's pretty simple and straightforward. The program was written
using Turbo C 2.01. The only other thing you may wish to know
is the exit codes which are:
Errorlevel 0 - Successfully executed with no errors
Errorlevel 1 - Can't find the Users_file
Errorlevel 2 - Can't create the Bulletin_file
Errorlevel 3 - Can't interpret the Security_level
Errorlevel 4 - Can't find the [title.ext]
Errorlevel 5 - Can't find the [caption.ext]
Errorlevel 99 - No command line parameters were given
The program only takes about 4 seconds to process a USERS file
containing approximately 500 names using an Acer 1100 386/16mhz
or 12 seconds using an 80286/10mhz clone.
<page 2>
Obligations and promises...
<This space intentionally left blank>
Legal mumbo-jumbo...
Use this program at your own risk. You assume all liabilities
and responsibilities regarding the use and operation of this
program and any effects it may have. Sorry, but for the price
we're charging for it we can't afford a lawyer!
<page 3>